Inside Macintosh: QuickDraw GX Objects /

Chapter 4 - Colors and Color-Related Objects / Colors and Color-Related Objects Reference

Color Set Functions / Creating and Manipulating Color Set Objects

GXDisposeColorSet

You can use the GXDisposeColorSet function to release a reference to a color set object.

void GXDisposeColorSet(gxColorSet target);

target

A reference to the color set to dispose of.

DESCRIPTION

The GXDisposeColorSet function decrements the owner count of the color set specified by the target parameter and releases any memory used by the color set if the owner count goes to 0.

SPECIAL CONSIDERATIONS

If you attempt to dispose of a color set object used by an onscreen view device, this function posts a colorSet_access_restricted warning.

ERRORS, WARNINGS, AND NOTICES

Errors
colorSet_is_nil
Warnings
colorSet_access_restricted	(debugging version)

SEE ALSO

Owner counts are discussed in the section "Copying, Comparing, and Cloning Color Sets and Color Profiles" beginning on page 4-44, and in the section "Manipulating Owner Counts" beginning on page 4-46. To examine the owner count of a color set, use the GXGetColorSetOwners function, described on page 4-69.